Business Shareware/Business Shareware.iso/start/disk/tcpy200/tcmanual.doc

Text File | 1993-03-22 | 23.5 KB | 481 lines

     TTTTT  U   U  RRRR   BBBB    OOO    CCC    OOO   PPPP   Y   Y
       T    U   U  R   R  B   B  O   O  C   C  O   O  P   P  Y   Y
       T    U   U  RRRR   BBBB   O   O  C      O   O  PPPP    YYYY
       T    U   U  R   R  B   B  O   O  C   C  O   O  P          Y
       T     UUU   R   R  BBBB    OOO    CCC    OOO   P      YYYY


                              version 2.00

                     by Pierre J. le Riche 1991-93

              A Speedy Multi-Volume File Transfer Program

                         General User's Manual

***************
*Introduction:*
***************
First of all, thank you for downloading TurboCopy. I hope you will find
it very useful. To cut a long story short: TurboCopy is a copy program
much like XCopy but with many extra features (which we will come to
later), the most remarkable being it's built in floppy disk cache (which
provides for some ultra fast copying), it's capability to process
multiple volumes and the ability to slice big files.

**********************
*System Requirements:*
**********************
Any IBM compatible computer with BIOS version later than 1/1/1986. DOS
version above 3.00 (5.00 or higher recommended). 384K conventional
memory required for floppy cache, 72K absolute minimum (104K when
manually selecting files). Will utilise extended and expanded memory if
available. TC runs in any text mode from 80x25 to 132x60 or higher
resolution. TC will autodetect your screen configuration.

****************
*Why TurboCopy?*
****************
Have you ever become fed up with DOS's slow copy command, or XCOPY's
cryptic display, or the fact that when you want to backup a big program
you have to pick the files manually and copy them onto floppy disk one
by one? Your troubles are over with the new release of TurboCopy.
TurboCopy copies files lightning fast, offers a very informative
display, and prompts for new disks as they are filled, all the time
sorting the files so that the minimum amount of disk space is wasted.

******************
*How to register:*
******************
If you use TurboCopy frequently, you MUST register. From time to time
new versions of TurboCopy will be released. To make sure that you get it
as soon as possible you can send the MINISCULE amount of R20 ($15 US
overseas) to the address below and you will receive the latest version
as soon as it becomes available. Please specify whether you want it on a
5¼ or 3½ inch disk. (Hints and suggestions for future versions are also
welcome.) The order form is in the file TCORDER.FRM included in the
package. Send all queries to:

                Pierre J. le Riche
                P.O. Box 209
                Kuils River
                7580
                Rep. of South Africa

Or one of the following E-Mail addresses:

                [e-mail]
                [e-mail]


******************
*Getting started:*
******************
TurboCopy's command line is almost completely compatible with that of XCopy,
so if you know your DOS, you shouldn't have any trouble with TurboCopy.
To get acquainted with TurboCopy, run TC with no command line. You
should get the following display:


TurboCopy V2.00  -------  Pierre J. le Riche  -------  03/21/93.
Speedy multi-volume file transfer program. Copy freely, but no modifications.

TC source[;includefiles][,excludefiles] [destination] [/options]
 B           Manually select source files to be included in copy.
 D[D]:d-m-y  Only files modified on or after [before] date will be copied.
 F[F]:size   Only files equal or larger [smaller] than size will be copied.
 H[H]        Include hidden and system files in copy [remove attributes].
 L:listfile  Read source filespecs from listfile.
 M,A         Copy archives only, reset/don't reset archive attribute.
 N,O,E,I     Overwrite if newer/Overwrite all/Append/Skip existing files.
 Q[Q][:lbl]  Quickformat target diskettes [unconditional] [set label].
 S[P][C]     Include subdirectories [prompt] [disable subdir creation].
 T:level     Specify a text output verbosity level of 0 to 9.
 U,V,W,Z     Update settings/Verify files/Wait for keypress/Enable cache.
 X[R]        Move files to destination [remove empty source dirs].
 Y[:disks]   Specify multiple source disks [number of disks].

If you find this program useful, and use it often, you should
register. As a registered user you will be entitled to one free    P.O. Box 209
upgrade. Please send your cheque for R20 ($15 overseas) to the     Kuils River
address on the right and state 5¼ or 3½ inch disk. All advice      7580
and suggestions for future versions are also welcome.              South Africa


Above is TurboCopy's cryptic help screen. Options are mostly grouped
together by function. E.g. N,O,E and I options all have to do file
inclusion or exclusion from the copy process. Options are not case
sensitive, so you can type them in either lower- or uppercase.

************************************
*Rough overview of TC command line:*
************************************
You must always supply TC with a source path. (The current path is
assumed to be the destination if none is given.) A source path consists
of some kind of drive/directory identification and optionally file
specifications (*.* is assumed if none is given). Therefore "."
identifies as all files in the current directory, ".." all the files in
the previous directory, "A:" all the files in the current directory on
drive A:, and so on. File specifications ("filespecs") can be very
diverse. The following rules apply to TurboCopy filespecs:
1) Unlike DOS the following is completely legal: "*foo*.*", this will
   match all files with "foo" somewhere in it's name, e.g. "kfoobar.xyz"
2) You may use Grep style search characters, i.e. "[","]" and "^". For
   example "[a-c]*.*" is functionally the same as "a*.*", "b*.*" and
   "c*.*". The filespec "[afq]*.*" will copy all files starting with the
   letters a, f or q. You may also precede the characters with a "^"
   sign which means "everything except". You may also wrap through z
   back to a, e.g. "*[^x-b].*" will match all files that doesn't end
   with an x,y,z,a or b.
3) You may specify more than one filespec by separating them with an
   ";", i.e. "*.txt;*.doc" will match all files with .doc or .txt
   extensions.
4) You may also specify filespecs to exclude from the copy by preceding
   them with a ",", i.e. "*.?oc,myfile.*,sam?.voc" will copy all files
   with an extension matching .?oc, except "myfile.*" and "sam?.voc".
5) If you start a source filespec with "," or ";" it would indicate that
   all files is included before the expression after the ";" or "," is
   evaluated. Don't end the filespec list with a ";" since this will
   include all files.
You may specify a directory that does not exist in the destination
filespec, TC will create it automatically. You may also specify a
general rename filespec in the destination, just like with copy and
xcopy. If you specify a destination of "NUL", TurboCopy will only verify
the source files; nice if you want to check if your disks are OK (/X and
/M options will be ignored). After the source and destination filespecs
(or before, if you prefer) you may specify certain options, which will
be discussed in detail below.

********************
*TurboCopy options:*
********************
You do not have to start each option with a forward slash (/), instead a
slash is used to identify the start of the options list. If an option
letter is followed with a "-" the option will be disabled (if the
default was on; refer to "setting up TC"), "+" will enable the option
(same as specifying nothing), and "=" will toggle the current setting.
The options list must follow directly after the destination filespec or
must precede the source filespec, but not in between. The following is
an example of a completely valid TC command line:
 tc c:\asm\tc.*,tc.asm;tcbench.doc;file[1-3].doc a:\/xvo
It will move tc.* (except tc.asm), tcbench.doc, file1.doc, file2.doc and
file3.doc to a:\. It will do a complete read after write verify of the
data, and it will overwrite the files if they already exist.

*******************************
*Alphabetical list of options:*
*******************************
/A
The /A option will copy ONLY files with their archive attribute set. It
is similar to /M, but it does not reset the source file's archive
attribute after the copy. It is of limited usefulness, but is implemented
in TurboCopy to ensure compatibility with xcopy.

/B
The /B option allows you to manually include and exclude files from the
copy. TC will list all files matching the source filespec(s) and you may
then select the files with the arrow keys and space. If only one file
matched the source filespec, TC will ignore the /B option and copy the
file without prompting. (Please refer to the section 'Manually selecting
files'.)

/C
The /C option is ignored if used without the /S option. The /C option
instructs TC not to create subdirectories on the destination (except the
base destination directory specified in the destination filespec). It is
useful if you want to search your hard drive for specific files and copy
them to floppy without their respective directories, e.g.
        tc *.asm a:\asm\/sc
Assuming your current drive is your hard drive, TC will search the
entire drive and copy all .ASM files onto the \ASM directory on the
floppy disk in drive A:, creating the directory if necessary. TC will
warn you if two source files with the same name exists, and ask for an
appropriate action.

/D[D]:date
The /D option allows you to copy only files modified after or before a
certain date. The date must be in "day-month-year" format. The semicolon
is not required and you can use any seperator between numbers. The
second (optional) D is to specify that you want to copy only files
modified before that date and not after (or on) that date.

/E
This option instructs TC to assume that you want the source file to be
added to the end of the destination file, if the destination file
already exists. It is useful when adding together files that have been
split with TurboCopy (refer to section on file splitting) or some other
program. The following command will add four files together into one big
file: TC file0;file1;file2;file3 bigfile/e. It is functionally the same
as typing COPY /B file0+file1+file2+file3 bigfile.

/F[F]:filesize
This option works in much the same way as /D, except that you specify
the file size and not date. TC will only copy files larger or equal to
"filesize", unless you specify the second F in which case only smaller
files will be copied. You may specify that the size you typed is in K by
appending a "K" to the end of "filesize", e.g. TC *.txt a:/FF128k will
copy all .txt files smaller than 128k to drive a:.

/H[H]
The /H option instructs TC copy hidden and system files as well as
normal or read-only files. The default may be changed, please refer to
"Setting up TC". To disable the option if the default is "on", use /H-.
The second (optional) H is to tell TC to drop the hidden and system
attributes from the destination file.

/I
This option instructs TC not to overwrite files that already exist on
the destination drive. TC's default is to prompt the user when a file
already exists. TC will skip all existing files if /I is specified.

/L
"/L:filename" forces TC to read a file list from "filename" and copy
only those files. Any source filespec specified on the command line is
ignored. You must still specify the source path and destination path,
since no directory or drive names are allowed in the list file. All the
standard wildcards are allowable though. The following command will read
the filenames to copy from mylist.txt:
        TC c:\asm\ a:\backup\/l:mylist.txt
Where "mylist.txt" might contain something like this:
        *.asm,tc.asm
        *.doc,pogo.doc;*[1-9].dat
        ,file7.dat
Note that exclusions should generally follow inclusions, since TC scans
the whole list for each file, and decides the fate of each file on the
last positive match. Therefore ,tc.doc;*.doc will copy tc.doc, whereas
*.doc,tc.doc will not. To avoid confusion with other command line
options, you may put the filename in quotation marks (") or you may end
it with a forward slash (/). The colon following /L is not required.

/M
The /M option copies only files with their archive attribute set (like
/A), but unlike /A the source file's archive attribute is reset after
the copy. It is a most useful way of keeping track of files that have
been copied when doing a backup bit by bit.

/N
The /N option is much the same as the /O option (being that it will
overwrite the destination file if it exists), but it will only overwrite
the destination if the source file's date is later than the
destination's.

/O
The /O option will force TC to overwrite all destination files that
already exist.

/P
The /P option is ignored unless used with the /S option. When this
option is used with /S, TC will ask you whether it should copy each
subdirectory, one by one. It is useful when you want to do a complete
backup of your hard drive, but want to exclude one or two directories.
Example: TC c:\ a:/sp will ask which subdirectories it should copy.

/Q
The /Q[Q]:label option is most useful when you want to clear the
contents of your destination floppies if they already contain files. The
Q stands for Quickformat, so use this option with the necessary care.
The optional second Q is to force TC to quickformat the disk, otherwise
TC will prompt you if the disk already contains data. You may also
(optionally) specify a volume label for the disk. To avoid confusion
with other command line options, you may put the label name in quotation
marks (") or you may end it with a forward slash (/). You can optionally
number your disks by inserting an asterisk (*) in your volume label,
which TC will replace with the current disk number. Example:
        tc . a:/qq"mydisk #*"
Will quickformat all destination floppies (unconditionally) and label
them mydisk #1, mydisk #2, mydisk #3 and so on. If you follow the Q's
with a colon, but don't specify a volume label, the current label will
be deleted. The /Q command will be ignored if the destination drive is
not a floppy drive or if the source and destination drives are the same.

/R
The /R option is most useful when used together with the /S and /X
options. After all files have been copied, TC will check all source
subdirectories and remove them if they are empty. For example:
        tc d:\games c:\games\/srx
Will move your complete games directory (including subdirectories) from
drive D: to drive C:.

/S
The /S option forces TC to include all source subdirectories in the
copy. The subdirectories will be created on the destination unless /C
was specified. /P forces TC to prompt before each directory.

/T
This option allows you to specify a verbosity level. What it boils down
to is that you can tell TurboCopy how much useless information you want
displayed on the screen. /T9 is the most verbose while /T0 displays
nothing except error messages and prompts.

/U
The /U option allows you to configure TurboCopy for your personal needs.
It will pop up a menu box in which you can, for instance, set the
display colours. Use the up,down,left and right arrow keys to change
default selections. Pressing ENTER will prompt you whether you want to
save the changes or not. *NOTE* It is completely save to compress TC
with executable file compressors like lzexe and pklite, since TC
rewrites itself completely every time the configuration is saved. Please
refer to setting up TurboCopy.

/V
The /V option forces TC to verify all new files created on the
destination. If the destination is a floppy drive, and the floppy cache
is enabled TC will do a complete read after write verify, which is as
thorough a verify as you can get.

/W
/W forces TC to wait for a keypress before commencing operation.

/X
The /X option forces TC to move files to the destination, which means
that the source files will be deleted. If the source and destination
files are on the same disk TC uses the DOS rename function which speeds
the process considerably.

/Y[:source disks]
The /Y option allows you to specify that you want to copy from more than
one source diskette. TurboCopy will ask for the next source disk as they
are copied. You may optionally specify exactly how many floppies to ask
for (from 2 to 99). By default TurboCopy will go on until the user opts
to quit. If the source is not a floppy drive this option will be
ignored.

/Z
You may enable/disable the internal floppy writeback cache with /Z and
/Z-. You can also set the default fromout the setup menu (Refer to
"Setting up TC"). It is recommended that you keep the cache enabled
unless you experience compatibility problems with other packages. TC's
cache has been tested with Vadim Vlasov's Combi-Disk and Norton Cache
and works fine (even with floppy writeback). Please inform me if you
experience problems with other cache programs.

***************************************
*Manually selecting files to TurboCopy*
***************************************
If you are a fan of the popular Norton Commander package, I am sure you
will appreciate TC's manual file selection option. To be prompted to
select files manually, specify the /B option on the command line. TC
will then pop up the list of files matching the source filespec(s). You
may now select files either with a mouse (only in 80x25 mode) or with
the keyboard. The following are valid keystrokes:
 '+'      The plus key will toggle all file selections.
 '-'      The minus key will unselect all files.
 '*'      Toggles the way in which the files are sorted. Files are
          sorted either by extension or by filename.
 'INS'    The insert key will toggle the current file and move the cursor
          down to the next file.
 'SPACE'  The spacebar will toggle the current file.
 arrows   You may use the arrows, the page up/down keys and home and end
          to position the cursor (the blue marker).
 'ENTER'  Proceed to copy the marked files.

 (You may also press Break or Escape at any time to abort the copy.)

*******************
*Slicing big files*
*******************
If TC detects that certain files are too big to fit on the destination
media type it will prompt you whether you want to slice the file into
smaller bits so it does fit. If you do decide to slice the file you will
be asked whether you want to change the file's extension or time or
whether you want to change nothing. If you opt to change the file's
extension, the first file's extension will remain intact, but from there
on the last two characters will be replaced with a 01, 02, 03 and so on,
depending on the number of disks required to hold the file. If you opted
to change the file time, the minutes part of the file's time will be set
in the same way as above. An easy way to add the files together again is
to use TurboCopy's /E option.

**********************
*Setting up Turbocopy*
**********************
If you want to personalize your copy of TC, you may do this with the /U
option. The following screen will pop up, and if you are in 80x25
mode, mouse support will be enabled:


|---------------------------------------------------------------------|
|             TurboCopy v2.00 - Update Default Settings:              |
|                                                                     |
|            [ ] Manually select files (/B- disables)                 |
|            [ ] Copy hidden & system files (/H- disables)            |
|            [ ] Include subdirectories (/S- disables)                |
|            [ ] Verify destination files (/V- disables)              |
|            [√] Enable the floppy cache (/Z- disables)               |
|            [ ] /B defaults to all source files selected             |
|            [√] Display cache status during writeback                |
|            [√] Display active options list at startup               |
|            [√] Beep between multiple diskette volumes               |
|            {S} Dialogue box style (Single or Double)                |
|            {N} File sort filter (Name or Extension)                 |
|            {Standard} TurboCopy colour set selection                |
|            (9) Default text output verbosity level                  |
|            (7  ) Attribute for normal text                          |
|            (15 ) Attribute for highlighted text                     |
|                                                                     |
|  Change settings with the arrows and <SPACE>. <ENTER> to continue.  |
|---------------------------------------------------------------------|


You can move the highlight with the arrow keys and you can change fields
with the left and right arrow keys (or space). ENTER ends the setup. Most
options are self-explanatory. I will briefly describe the others:
*The file sort filter specifies how files should be sorted in the "Manual
 file selection" box.
*The default box style is there so you can choose double line or single
 line borders for all the popup boxes in TC.
*The attributes are the colours that TC uses for the display.
*I strongly recommended that you keep the floppy cache enabled unless you
 want to use some other floppy writeback cache.
*The cache status box is the box with the stripe that TC pops up while
 it is doing it's cache writeback. (Only displayed if the total amount
 of data to be flushed is more than 128K.)

******************
*Acknowledgements*
******************
I wish to thank everybody who encouraged me during the time it took me
to write TurboCopy, and also for everybody who gave their insights and
helped with the testing of the program.

************
*Disclaimer*
************
I take no responsibility for damages arising from the use or the
inability to use this product. I have tried my utmost to make this
program as reliable as can be, but cannot be held responsible if
anything goes wrong.

***************
*Compatibility*
***************
TurboCopy has been extensively tested on many machines, with excellent
results. So far I have only encountered one machine that is incompatible
with TC's built-in cache. Please inform me if you have any problems.

*********
*License*
*********
The unregistered version of TurboCopy is not crippled in any way, it is
also not infested by nasty little advertisements, time delays, etc. like
many other programs. I assume that people have the decency to
acknowledge my hard work and make a contribution if they use this
program frequently. The registration is a ridiculously low fee of R20
($15 U.S. outside of the R.S.A) which means that nobody can afford not
to register.

******************************
*Messages & Technical support*
******************************
For the time being you may contact me by mail or through André Mostert
at one of the E-Mail addresses given below (available till at least
May 1993):

[e-mail]
[e-mail]



                                         -Pierre J. le Riche, March 1993